Samurize v1.64 Release ======================= ReadMe file updated: 2006-05-22 by AdamC (c) Copyright Gustaf, Oscar. All Rights Reserved. Authors: Gustaf (Cure) Mail: cure@samurize.com Oscar (Sim) Mail: sim@samurize.com Continued by: Adam (AdamC) Mail: adamc@samurize.com Lee (NeM) Mail: nem@samurize.com URL: www.samurize.com The authors of Samurize takes no responsibility whatsoever for any damages this program may cause to your hardware, software or personal life. System Requirements: ==================== * Microsoft Windows™ 2000/XP/2003 Operating System. * GeForce 1 (or better) graphics card (required for desktop client) Quick Introduction: =================== Samurize is a fully customizable system monitoring application that displays system information, news, weather and much much more on your desktop. It uses a very small amount of resources (less than 1% CPU usage on a Celeron 600) Quickstart Guide: ================= Samurize consists of two main programs: the desktop client (Client.exe, hereafter referred to as the Client) and the config editor. The config editor is a WYSIWIG editor used to create Samurize "configs". A config is a file that tells Samurize what to display on the screen. To use the config editor, right-click in the large area labelled "Design Area" and select various meters from the popup menu. You can change the way that Samurize visualises the data by changing the "Draw Type" under the "Meter Properties" heading on the right-hand side of the config editor using the pulldown menu. You can also add static graphics to your config using the "Edit Graphics" tab. Once you've finished creating your config, save it to your Samurize/Configs directory. The Client is used to display a config on your desktop. When you run the Client, an icon (it looks like a grey circle with an 'S' in it) appears in your system tray. Right-click on the tray icon to see the Client options. To load a config you have created, select your config file from the "Select Config File" menu. A simple config (called Sample.ini) is provided to get you started. The best way to learn what Samurize is capable of is to play around with the program yourself, but if you have trouble working some things out, feel free to stop by www.samurize.com and check out our FAQs, Tutorials and forums. Chances are someone else has already asked how to do something you are trying to do. The only limit to Samurize is your imagination - so get out there and get making configs! :) Taskbar Client: =============== The taskbar client allows you to display Samurize configs embedded in the Windows taskbar. To enable the taskbar client, you will have to right click on your Windows taskbar while it is unlocked and select Toolbars->Serious Samurize. Then just right-click on the newly created toolbar to select a config and other options. Server Executable: ================== The newest addition to Samurize is the Server program (SamurizeServer.exe). This program is similar in behaviour to the desktop Client (it puts an icon in your system tray and has similar options), but instead of drawing a config on your desktop, it outputs the config in graphical format (to a PNG file) or in XML format so you can monitor computers remotely over the internet or export information to other programs. Check out the "Server Options" menu entry in the system tray popup menu for Server-specific options. Uninstall information: ====================== Run the uninstallation program (using the Windows Control Panel->Add/Remove Programs or the Uninstall shortcut in the Samurize Start Menu folder). Samurize also writes some information to the registry. Path: HKEY_CURRENT_USER\Software\Serious Samurize Just delete this registry key. =================================== Serious Samurize Software Agreement (EULA - End User Licence Agreement) =================================== This document is a legal agreement ("Agreement") between you (an individual, group, business or entity) and the authors of this software, the Samurize Crew. BY INSTALLING, COPYING OR OTHERWISE USING THE PRODUCT (AS DEFINED BELOW), YOU AGREE TO BE BOUND BY THE TERMS OF THIS AGREEMENT. IF YOU DO NOT AGREE TO THE TERMS OF THIS AGREEMENT, DO NOT INSTALL, DISTRIBUTE OR USE THIS SOFTWARE. The Software: ------------- This software (Serious Samurize) is copyright 2003-2006 by Gustaf Lundh. It is free for personal use. If you wish to use this software in any business or commercial environment, for profit or not, we require that you make a donation of $US5 (five American dollars) per workstation/server to help cover our costs and give the Samurize Crew some compensation for their work. Liability Statement: -------------------- Serious Samurize is provided as-is and is used at your own risk. Any information or statistics you get from this program may not be 100% correct so DO NOT RELY ON ANY VALUES THIS PROGRAM REPORTS. If in question, always suppose the values reported by the recommended software from your hardware vendor is correct. This program was created with the best intentions to provide system information and more but we (the Samurize Crew) cannot be held responsible for any hardware, software or any other problems that may arise during the use of this software. Distribution: ------------- Provided that you specify that you are distributing this software as freeware, you are hereby licensed to make as many copies of this software and its documentation and it in its original, unmodified form via any means, electronic or otherwise. There is no charge for any of the above, but you must mention the donation requirement for commercial users as mentioned above. However, you are prohibited from charging or requesting donations for any copies of this software, and from distributing the software and/or documentation with other products (commercial or otherwise) without prior written permission. Further information: -------------------- Should you have any questions concerning this Agreement, or if you desire to contact the authors for any reason, please email one of the following people: Adam Coulthard (adamc@samurize.com) Lee Wilson (nem@samurize.com) Or visit www.samurize.com Version History: ================ v1.64 release ------------- Bug Fixes: * Fixed a bug with Increase/Decrease/change alerts with Images * Fixed bug that remote meters only read one line * Fixed bug with Remote meter Port settings in the Config editor * Fixed a bug with Value Contains / Doesnt Contain if the value is space * Fixed a bug with the unique meters not being selected correctly in the meter list * Fixed bug with server not saving the port correctly if changed from 9090 * Fixed bug with perfmons that needed a reload (at least I believe I have....) * Fixed bug with incorrectly holding Window State for AppBars * Fixed bug with AppBar locations and multi-screen * Fixed bug with Border width settings for Meters and Graphical Objects * Fixed bug with PNG images being downloaded from the web * Fixed bug in Vertical scroll when using %tab * Server sends back better informational messages in Remote Mode * Fixed default image so that it downloads correctly from internet * Fixed Fade problem bug * Fixed a bug with Tool Tips being cached if no tooltip was returned on the next refresh * Fixed ToolTip so that it returns the value without re-calling the function * Fixed Memory Leak in Meter Linkage * Fixed Pause Config bug when reloading a config * Fixed Alphabetic sort problem with MeterList * Fixed Bug with Group renaming in MeterList Changes/Improvements: * Alert Images can now use %v within them * Upgraded Graphical Components to latest level * Added a new color preference for selected and highlighted meters * Enable dragging and dropping between groups * Added a WM_PAINT message enabling people to get access to the Samurize produced bitmap * Option to display text in toolbars of the config editor * Shadow Color added to Preferences * Default number of lines for Text File meters increased to 10 * MeterList group selection now works correctly. * MeterList Multi selection working using ctrl * Date / Time Meter has time zone support * POP3 Trace within Config Editor * Eclipse supports configurable border size * WM_SAM_SHOW lparam = 1 will give focus to the samurize window * Added further png image support * Autohide added to Appbar Functionality * Locale fix for Plugins and Scripts returning , or . will be changed to the local Decimal Separator instead * Added command line parameters for Docking the client window * Up/Down Meters can have multiple network cards selected * Changed draw order of the Grid/Borders * Added Proxy support to images * Rulers have been added to the config editor * Added ZOrder for Meter List (note that Graphical Objects will always be at the bottom of the list) * Click through has been turned off by default when first load of client * Added ability to force Antialiasing of Text (meaning it doesnt have to be turned on in the rest of windows). * Meter Maths is not allowed to be used with 'Text Meter' (source not output) so its been disabled. * Text shadow will allow negative values * Design Area size can be customized (Advanced users only) * Gradient Fill Progressbars * Progress bars can have a raised effect * Updated Windows components to Latest level * Holding space when Design area has focus will allow you to move it around. * Added WM_SAM_GET_SAMURIZE_DIRECTORY support to the Config Editor. * Meter Maths now copes with adding strings together. * Added WM_SAM_GET_PROXYSETTINGS support to the Config Editor. * Description added to plugin about and about button added to input plugin panel. * Graphical Objects can have shadows when in fill mode (Currently line doesnt work) * Completely redone how Input actions are added to Meters. * Text Meters are now sorted correctly. * Uptime meter has padding values * Meter unique checking only occurs when leaving the Edit Box New Features * Samurize will hide and pause if a window goes full screen (game/video) * Pause meter function added to Config Editor AMPI Changes/Improvements * Several bugfixes * Using covers from id3v2 tags now correctly distinguishes between .jpg and .png files * Priorities changed: id3v2 takes priority over folder.png, folder.jpg files * Moved foobar plugins from 0.8x sdk to 0.9x sdk, therefore the foobar plugins will no longer work with foobar 0.8 * Fixed 3D screensaver issues on nvidia cards * Added %pstat variable (player status string) * Currently playing info is cleared when the player is stopped * Album cover downloader now supports proxy settings (use the samurize config editor to set them) * Winamp 3 is no longer supported * Quota settings (disabled by default): edit AdvancedMediaPlayerInfo.opt to change. when enabled, ampi deletes cover files in your global cover dir when the sum of the file sizes is greater than the set quota. oldest files are deleted first. the quota is only examined when ampi needs to download a new cover. v1.63.1 release ------------- Bug Fixes: * Fixed Remote Meters * Fixed problem with limited User Accounts * Fixed blurry images when downloading * Fixed problem with 'Value has changed' not working correctly. * Fixed a bug with Value increase and value decrease * Fixed a bug with Language files not being supported by the new actions list box * Fixed a number of small bugs in the Language Code. * Fixed a bug in Text Shadow not being removed correctly * Fixed Memory Leak in Image drawing Changes/Improvements: * Added an update interval to force an image update if its on the web(images from files ignore this option) * Added additional code for Vertical scrolling so it only scrolls when it needs to. * Added Alpha and Color for Text Shadow Alerts (Use Alpha Color 2) * Improved File Accessing if File locked then [File Locked] is returned v1.63 release ------------- Bug Fixes: * Fixed bug when saving config with no meters. * Fixed the default values for the ToolTip * Fixed blending problem with the Visual Plugins. * Fixed a Selection bug in the meter list. * Fixed a bug in the Decimal points of the Tool Tip meters. * Fixed if blank Linkage the link is not run. * Fixed a bug in the tray icon not changing when using the commandline options. * Fixed the config editor not returning the language file name and config file name when using the plugin api. * Fixed actions to ensure they are cleared correctly if a source plugin doesnt return the information. * Fixed a bug in the alert meter image alert processing. * Fixed bug with single click occuring with double clicks. * Fixed problem with repeating lines in the Text Meters. * Fixed bug with client not saving location on windows shutdown. * Fixed a Bug with copy and pasting Visual Plugins * Fixed Uptime meter so that it will go up-to 49 days now * Fixed bug in upload and download * Fixed bug with Text File meter losting the last character in a file * Fixed bug with ToolTips not honouring %b and %tab * Fixed bug in the Client that wasnt holding Click Through correctly * Fixed bug in Instance Manager / client to ensure they are in step Changes/Improvements: * Text Shadowing. * Transparent area color setting for Background images. (Not been added to meter images because it would significantly increase CPU usage). * Meter Centering when selected on the meter list. * Day ordinal has been added (used in conjunction with the language file). * Edit instance of the instance manager has been made wider. * Meter Linkage now tries to work out the working directory for the file passed. * Added %dl, %dr and %dm for double clicks to be returned by plugins and scripts. * Added a new return value for the tooltips, %vl. This is replaced by the %tt value if present returned by script/plugin. * Alerts can now have Custom Text returned. * Added option to trim alert value before doing the alert compare processing. * Added Mouse Up / Mouse Down for Left, Right and Middle mouse buttons (none of these actions work for Right in the taskbar). * Meter Linkage will now work on Mouse Over/Out and Mouse Enter/Leave.. * Graphical images and Image Output Types now support http:// downloading. Animated Gifs not allowed at present. * Removed the Text File size limit of 8k. * Taskbar will now honour the commandline parameters to use call as client.exe taskbar . * Grid and Highlight colours can be changed in the config editor. * If ToolTip Text is over 999 then the text is truncated. * Input Plugins can now force an update for the meter that they are associated with. * Add alert values If Value has increased, and if value has decreased. * Added keyboard input for input plugins. * All Standard Meters are allowed a background color with an alpha blend. * All Standard Meters are allowed a border. * Rectangle has border width (if useful will add to other rectangle object). * Mouse Drag Input option has been added * Improved selection of the Inputs in the Config Editor * Improved Copy and Paste code so that you can copy and paste across multiple instances of the config editor. * All Standard Meters can draw a grid * MeterList distiguishs between Meters and Graphic Objects * Saved Config added to latest used list * Mouse Wheel Up / Mouse Wheel Down have been added * Maintain Aspect ratio has been added to Graphical Images * Encryption has been added to proxy password * Variable Number of Recent Configs * Meter Names are now unique, using the group as part of the name * Sorting of the Config Menu in all Clients (Optional) New Features: * Meter Maths. * Remote Meter to monitor the new samurize server (rather than just xml and png, it will allow you to get information straight into samurize). v1.62 release ------------- Bugfixes: * Fixed a couple of bugs with the MeterList - Selection problems mainly * Fixed the problem with the preference panel not displaying labels * Fixed a problem with meter caching after a reboot * Fixed a bug in the Config editor not passing its HWND to Input plugins * Fixed a bug with the update interval after a new reboot * Fixed a bug Source plugins configure Changes/Improvements: * Windows Link files are resolved correctly on meter linkage * Easier to add plugins to a config * Meter Name is now copied correctly on a copy or cut (prefixed with copy of if same name exists) * Grouping has been added to the meter list * Tooltips have Popup delay and Time to display for * Meter List now has simple grouping * Added Text Formatting to the ToolTip Input * Upgraded the Graphics driver for some minor bugs fixes * Meter/Group Locking * Vertical Scrolling for Text Meters * Multiple Alerts * New alert type 'If value has changed' New Features: * AppBar on the samurize client * Hide Icon can be specified so you can tell your client is hidden * Samurize Update will automatically sense a new version of samurize * Icon Packs for the Config Editor v1.61 release ------------- Bugfixes: * Fixed bug with script parameters being empty * drivespace meter copy bug fixed * 'hide' commandline arg can be used to start clients hidden * fixed Invalid Floating Point error on Graphs when using Peak Meter * Drivespace % bug fixed * fixed test all scripts/plugins bug * %m/%h date/time variables now truly 'smooth' * %hr[r] displayed 12o'clock as 0o'clock - fixed * fixed ICO file loading bug * improved plugin list loading times Changes/Improvements: * upgraded graphics engine, improved blending/antialiasing effects * Battery meters merged into one, formatting options added * WMI namespace entry * snap to screen edges snaps to windows taskbar * Updated the source_configure function for plugin writers (see help file) * Ctrl+Mousewheel changes zoom in editor New Features: * client fadein/fadeout * Config Editor Meterlist * Input SDK v1.60 release ------------- Bugfixes: * fixed graphic object height buttons bug * fixed minor alert bug * fixed minor graph bugs * fixed bounce scrolling bug * fixed large fonts problem with Instance Manager * Fixed Bug with leading and trailing spaces/tabs removed on Text Output * fixed Analog meter memory leak * fixed About box bug for visual plugins * fixed "No Disk" Drivespace meter error * leading zeroes now preserved in text display type * fixed instance manager error on first use * fixed Server pause bug * fixed commandline option bugs when instance/config names contain "reserved" commands * Pin to Desktop "Compatibility Mode" for users running multimonitor setups * fixed minor image bug so image does not get reset when clicking in the path box * fixed select config file menu bug * fixed png/xml server commandline options * 'close' commandline option does not open an instance if it is not running * fixed server PNG output bug when no config loaded Changes/Improvements: * loop N times for animated GIFs * translated Instance Manager * instance names no longer case-sensitive * multiline scrolling supported * zoom up to 1200% * individual refresh rates per meter * New Look Toolbars and Menu Bars * Improved Preferences Dialog Box * custom colors loaded/saved on show/close color dialog * upgraded graphics engine (should be stabler) * reduced CPU usage for Image display type when aspect ratio not maintained * 12-hour time display without AM/PM for DateTime meter * taskbar client API calls * snap to screen edges works with edges of multiple monitors * multiple drive selection for DriveSpace meter * Reload/Edit Config buttons, tray icon for instance manager * Instance manager menu option in clients * Min digits before decimal place for text display meter * pressing enter applies all edit controls * Text meter wrapping - words that are too long for a line are wrapped * %v works in sound/command alerts/meter linkage * tweaked tray icon to use 16x16 icons in preference to 32x32, and relative paths * image cropping option for Image display type * Config name added to client tray icon hint * Ctrl+Shift+V performs paste meter in original position * tweaked meter linkage/alert commands to pass parameters correctly * new icons (big props to JyriK) * Added Edit Image buttons to Background image and Meter Image properties * Proxy settings New Features: * Run Meters when Config loads into Editor * SpeedFan meter type * CPU priority * PHPScript support * Import Export tool for easy config sharing Installer: * Language settings * Winning configs from the last config competition are included v1.55 release ------------- Bugfixes: * fixed WMI crashing bug * fixed vertical alignment issue * fixed paste decimal issue * fixed 1-px antialiased graph bug * fixed bizarre floating point error * fixed rare activescript bug * fixed all decimal separator issues * fixed rectangle glitch * fixed config editor script saving bug * ... plus a few more Improvements: * added "actual" pagefile usage to memory meter * new AMPI (kudos to Tropics) * new Screensaver (kudos to Tropics) * middle mouse button = paste * tweaked scrolling * heaps of missing translations added * improved config loading error handling * improved script execution * improved script error reporting * minor tweaks to config editor * Winamp % playlist completion * DateTime week number * advanced WMI selection * scroll pausing * nopng/noxml options for Server * text truncation * selected config/language file indicated in menus * new sample C++ source plugin (thanks AdamC) * bottom panel in config editor shown by default for new installations * client "Run on startup" option * config editor assign to instance New Features: * abs. always on top for Client * horizontal graphs/histograms * rubyscript support * animated GIF support * instance manager application v1.50 Release ------------- Bugfixes: * DLL error fixed that caused tadis' Milk Suite to crash * fixed network paths issue * fixed IME issue for Asian users (improved config editor loading time) * fixed zooming in on small images bug * all/multiple perfmon selections now work as expected Improvements: * updated AMPI plugins (kudos to Tropics) * smaller zoom levels * next/previous meter cyclic * ctrl-pgup/pgdn for switching tabs * smooth scrolling * "bounce" scrolling * each instance can only be open once * environment variables expanded for script/plugin parameters * image antialiasing option in config editor * sound/command alerts can each have individual settings * custom WMI class input box for WMI chooser window * BMP/GIF/JPEG output formats for the Server * installer should close media players if installing/removing plugins for them * API enhanced New Features: * command line options galore! * Perlscript/python support v1.41 Release ------------- Bugfixes: * new POP3 password encryption * fixed Rectangle graphic object glitch v1.40 Release ------------- Bugfixes: * fixed memory leak with image ratio option * fixed peaking bug * fixed rare selection bug * fixed analog line width bug * fixed image path bug for Image graphic object Improvements: * updated AMPI plugins (kudos to Tropics) * file path displayed in config editor window title * option to disable config outline (including the warning) * next/previous keys changed to pgdn/pgup to allow field tabbing * scrolling in the Tools and Settings area reduced by introducing more tabs * more uptime options * new sample config (cheers Em7) * password encryption for POP3 password * latest 4 config files in file menu * open folder in Select Config File menu New Features: * Vastly improved plugin interface * base width for analog pointers v1.31 Release ------------- Bugfixes: * fixed several issues with nested config folders Improvements: * Config Editor warns when overwriting config files * Updated AMPI media plugins (kudos to Tropics) v1.30 Release ------------- Bugfixes: * fixed concurrency issues with SamurizeServer.exe * fixed Config Editor display bug in 800x600 resolution * uptime meter now allows longer than the previous 47-day limit * mouseover cursor uses system hand pointer Improvements: * relative paths for image filenames and textfile meters * improved handling for corrupt images * heaps more hotkeys * improved installer (remembers path, more configurable) * DTD/XML scema updated (some data missing) * additional command line options * a lot of code rewritten and improved New Features: * Maintain Aspect Ratio option for Image meter type * foobarv0.8 support for built-in foobar2000 meter * beginnings of the Samurize API v1.25 Release ------------- Bugfixes: * "Fixed" cleartype font problems (disable text antialiasing to improve readablility) * fixed values not being saved when 'save' selected while component has keyboard focus Improvements: * Config Editor preferences - set default script editor * Custom offset for analog meters * Set font properties globally in Config Editor * Text/Graph meter antialiasing can be disabled * Permanent meter peaks option * JPEG,GIF,ICO,BMP image support * Alert action occurence option (Always/Once) * Custom "Hide Tray Icon" hotkey * Updated media plugins (kudos to Tropics) - see SpectrumReadme.txt * Line graphic object redesigned * Updated help file New Features: * Underline, strikethrough formatting for fonts * Cursor changes over hyperlinks * Thousand seperators for numbers * Text meter scrolling v1.20 Release ------------- Bugfixes: * fixed PNG Meter image bug ('png') * "Track Resolution Changes" option removed (it wasn't helping) Improvements: * Updated media plugins (kudos to Tropics) * Improved vertical taskbar support * Default tab size increased * WindowsXP Look & Feel for Config Editor * Improved readme/installer * Multiple server instances allowed with different output settings * Configs can be organized in subfolders of the Samurize/Configs folder New Features: * Choose-Your-Own Tray Icon * Play sounds/perform commands on alert conditions * Line graphic object * Peaks for most meter types * Alert conditions for PNG Image Meters * Snap to screen edge option for Client * Word wrapping for Text meters v1.16 Release ------------- Bugfixes: * fixed progressbar splitting glitch * fixed align bug in config editor * fixed script parameter listing bug * fixed Pin To Desktop + "Show Desktop" bug Improvements: * next/previous in Config Editor centers on meter * update option in Client/Taskbar/Server v1.15 Release ------------- Bugfixes: * Winamp meter bugfixes for CD and streaming media Improvements: * copy/paste improvements * Resolution tracking behaviour of v1.1 is now optional * moving averages for histograms * text file lines increased to 100 * version checking option in Config editor * Alpha level for PNG Image meter * Reduced CPU usage for PNG Image meter * ID3v2 tag support for inbuilt Winamp meter (+ more tags) New Features: * "Value contains" alert value * background for pie meters * graphs can be filled with a seperate color * WMP9, iTunes, Winamp5 plugins (thanks Tropics) v1.1 Release ------------ Bugfixes: * a couple of paste bugs fixed * commented functions are now not parameterised in the config editor * WMI language bug fixed * Pin to desktop bug fixed in the client * 1px clipping on left of text meters fixed * workaround for Windows multimonitor glitch with fullscreen apps Improvements: * string alert values now work * progressbar alert color alpha also affects the background color * fonts remembered in config editor * project interval rate can now be as low as 50ms (use with care!) * plugin meters changed to run at project update interval * multimonitor support for the config editor * ID3v1.1 tag support for Winamp meters (title, artist, album etc.) * navigation of meters in config editor via button presses * zooming in the config editor stays centered * %tab for tabs in text meters * better C++ plugin sample code (kudos to Tropics) * added media player plugins (again kudos to Tropics) New Features: * Server program - outputs Samurize data to XML or a PNG image * Screensaver (by Tropics) - works in conjunction with the Server program to display a config as a screensaver v1.0.1 Release -------------- Bugfixes: * fixed language bug with taskbar * improved dyanamic PNGs rendering quality * copy/paste "Run more frequently" bug fixed * Select All bug fixed * Winamp meter bug fixed * fixed precision issues with meters v1.0 Release ------------ New Features: * Plugin meter * QCD meter * Config editor formatting options - alignment * Config editor merge command * PNG Image display type (dynamic - use with great care, can consume great CPU% if used too much) Bugfixes: * pie graphs, rounded rectangles & ellipses alignment fix * histogram 1-pixel shift bug fixed * WMI form resizing bug fixed * "Run every X min" translation bugfix * MBM farenheit bugfix * Zoom options not shown bug fixed * Fixed crashes caused by launching the client from a Dock app Improvements: * improved Winamp meter * DEFAULT_CHARSET for non-ascii languages * shift-resizing (preserving aspect ratio) in config editor * 1x1 pixel minimum meter size * X,Y, width,height for graphic objects * any single-click activates meter linkage * 24hr analog clock formatting option (%hh) * ActiveScripts more resilient to being configured wrong * Certain hotkeys prevented from being used (Caps Lock, Scroll Lock...) * Additional language fields (see LanguageChanges.txt) [The version history for pre-v1.0 Serious Samurize have been removed to make this file smaller]